1.背景介绍

MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以对配置和原生Map使用简单的 XML 或注解，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

2.知识剖析

2.1 基本知识

SqlSessionFactory：SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先定制的 Configuration 的实例构建出 SqlSessionFactory 的实例。

SqlSession：SqlSession完全包含了面向数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。

XML 配置文件（configuration XML）中包含了对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源（DataSource）和决定事务作用域和控制方式的事务管理器（TransactionManager）。

作用域和生命周期：

SqlSessionFactoryBuilder一旦创建了 SqlSessionFactory，就不再需要它了，因此该实例的最佳作用域是方法作用域，也就是局部方法变量。

SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由对它进行清除或重建，因此 SqlSessionFactory 的最佳作用域是应用作用域。

SqlSession：每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。绝对不能将 SqlSession 实例的引用放在一个类的静态域，甚至一个类的实例变量也不行，也绝不能将 SqlSession 实例的引用放在任何类型的管理作用域中。

2.2 Configuration.xml配置文件

properties标签

包含了mybatis的属性信息。如果属性在多个地方进行配置，mybatis加载顺序为：

--在 properties 元素体内指定的属性首先被读取

--然后根据 properties 元素中的 resource 属性读取类路径下属性文件或根据 url 属性指定的路径读取属性文件，并覆盖已读取的同名属性。

--最后读取作为方法参数传递的属性，并覆盖已读取的同名属性。

-- 从MyBatis 3.4.2开始，可以为占位符指定一个默认值，如：${username:ut_user}"

settings标签

设置mybatis的行为，通常采用默认设置，若有特殊需要，则在文件中显式设置。

typeAliases标签

类型别名是为 Java 类型设置一个短的名字。它只和 XML 配置有关，存在的意义仅在于用来减少类完全限定名的冗余。可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean，可以在Bean上使用注解。

typeHandlers标签

无论是 MyBatis 在预处理语句（PreparedStatement）中设置一个参数时，还是从结果集中取出一个值时，都会用类型处理器将获取的值以合适的方式转换成 Java 类型。可以重写类型处理器或创建自定义的类型处理器来处理不支持的或非标准的类型。

objectFactory标签

MyBatis 每次创建结果对象的新实例时，它都会使用一个对象工厂（ObjectFactory）实例来完成。可以创建自定义的对象工厂来覆盖默认行为。

plugins标签

可以在已映射语句执行过程中的某一点进行拦截调用。

environments标签

MyBatis 可以配置成适应多种环境，这种机制有助于将 SQL 映射应用于多种数据库之中，但是每个 SqlSessionFactory 实例只能选择其一。

transactionManager标签

MyBatis 中有两种类型的事务管理器：

JDBC – 这个配置就是直接使用了 JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务作用域。

MANAGED – 让容器来管理事务的整个生命周期，比如 JEE 应用服务器的上下文。如果使用 Spring + MyBatis，则没有必要配置事务管理器，Spring 模块会使用自带的管理器来覆盖前面的配置。

dataSource标签

dataSource使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。有三种类型的数据源：

UNPOOLED– 这个数据源的实现只是每次被请求时打开和关闭连接。

POOLED– 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来，避免了创建新的连接实例时所必需的初始化和认证时间。

JNDI– 这个数据源的实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。

mappers标签

可告诉 MyBatis 去哪里找映射文件，可以通过设置resource、url、class或指定Java bean包名等。

2.3 Mapper.xml映射文件

映射文件有几个顶级元素，按顺序为：：

cache：给定命名空间的缓存配置。

cache-ref：其他命名空间缓存配置的引用。

resultMap：用来描述如何从数据库结果集中来加载对象。

sql：可被其他语句引用的可重用语句块。

insert、update、delete、select：分别映射插入、更新、删除、查询语句。

2.4 动态查询标签

if、choose、otherwise、when：用于在查询时有条件地包含where子句的一部分。

trim、where、set：用于处理查询条件语句拼接的情况。

foreach：用于在构建 IN 条件语句的时候，对一个集合进行遍历。

bind：用于创建一个变量并将其绑定到sql语句上下文中。

3.常见问题

实际使用

5.编码实战

6.扩展思考

Mybatis与JDBCTemplate

Mybatis可自定义多种操作，在ObjectFactory中,在TypeHandler中,在Plugin中。这样方便排查在整个操作过程中可能出现的问题，但是需要写大量的实现代码。

JDBCTemplate使用简单，也可以自行处理一些操作异常，相比之下实现代码较少。

7.参考文献

参考：Mybatis中文文档

8.更多讨论

Mybatis实现更复杂的操作，如嵌套查询、联表查询等